Internet Info 1994 March/Internet Info CD-ROM (Walnut Creek) (March 1994).iso/networking/terms/kermit/b/k11ins.rno

Text File | 1989-06-12 | 34.7 KB | 989 lines

.rm 72
.index System requirements
.c;Installation and release notes for Kermit-11
.s 2
05-FEB-1987 09:42 Brian Nelson
.s 1
This is release 2.56 of Kermit-11. Major changes from previous
versions include LONG PACKET support, new CONNECT code for RSX-11M/M+
and P/OS, BREAK and DTR control for RT-11 V5.2, a DIAL command,
and many other small
changes. All changes are documented in the source file K11CMD.MAC.
.s 1
Kermit-11 runs on the following operating systems.
.lit

Exec    Minimum     Notes
    version

RSTS/E    v8.0    Multiple private delimiter SYSGEN support, RMS11 v2
RSX-11M    v4.1    Full duplex terminal driver, RMS11 v2
RSX-11M+    v2.1     Full duplex terminal driver, RMS11 v2
RT-11    v4.0    Requires multiple terminal SYSGEN support
RT-11    v5.1    Can use the XL and XC handlers or MT service
TSX+    v5    Must use CL handler for outgoing connections
PRO/RT    v5.1    Uses the XC handler
P/OS    v2.0    Uses either XK or XT (XT for TMS support)
IAS    v3.1    Built with RMS v1, will function on 3.2 patch A and B

.eli
If your system version is older than that listed you are free to see if
Kermit will run; if it does not, UPGRADE. Kermit is fairly generous, it
runs on both the current executive versions plus
generally contains support for
the last major release. In other words, if you are running RSTS v7 or
RSX-11M 3.2, you will not be supported for Kermit, just as your system
can not be supported by Digital. For example, RSTS/E 8.0 support expired
on 31-Dec-85, as version 9.0 was released in June 1985. Since version 8
was the last major version, Kermit-11 will ATTEMPT to support it for a
while; verification of 8.0 functionality is difficult as the author is
a field test site and has not used 8.0 since SEP 1984, and is currently
running RSTS/E 9.2.
.s 1
The creation of Kermit-11 from source is possible only on the current
versions of the above mentioned systems; this is due to the use of
new macro calls and directives that may not be present on older versions.
For example, Kermit-11 can be built under RSTS/E for all the other executives
as long as the RSTS/E version is 9.1 or later, and one has the appropriate
system specific libraries (such as SYSLIB, RMSLIB and RMSDAP from RSX-11M+).
Before attempting to build from source, see the section later in this
document for specific notes relating to your system. You should not need
to build Kermit from source; your distribution will have either the relevant
executable image or 'hex' files that can be converted into something that
will run.
.s 1
.test page 10

As of this writing (04-Feb-86), the current versions are:
.s 1
.lit
    RSTS/E     9.1, 9.2, 9.3     RSX-11M    4.2
    RSX-11M+ 3.0        RT-11    5.2
    TSX+     6.02        P/OS    2.0, 3.0
    IAS     3.2, Patch B
.eli
.s 1
.subtitle Warnings
.test page 10
.index Warnings
.s 2
.c;Restrictions to be aware of
.s 2
A problem was found with versions of Kermit-11 prior to 3.49 regarding
the sending and processing of attribute packets. Basically, two of the
attribute types were improperly implemented. The support for attribute
packets was added back in April 1984, at a time when testing against other
implementations was not possible. At this writing, in March 1986, some
problems have been found.
.s 1
The corrected version of Kermit-11 is V3.49; this version will NOT be
able to exchange attribute packets with previous versions. In order to
make an intitial download of Kermit-11 V3.49 to a host running an older
version, you must explicitly disable attribute support, as in:
.lit

    Kermit-11>SET NOATT

.eli
and then force both ends to binary mode, as in:
.lit

    Kermit-11>SET FILE BINARY
or:    Kermit-11>SET FILE TYPE FIXED

.eli
The best way to accomplish the updating of remote sites is to use
a pre 3.49 version of Kermit-11 at both ends, transfer the image
appropiate to your system, and then replace the old executable image
on the remote side and your own side.
.s 3
.subtitle A roadmap of files
.page
.lit

Kermit-11 files, 19-Feb-87  16:14:03 BDN

Notes:

1.  All command files (filetype .COM)  run under RSTS version 9. There
   are no build files for  native execs,  as I build all Kermits under
   RSTS and then download to the target system.

2.  All .HEX  files are simply  hexified versions of the corresponding
   executable image.

3.  The Columbia tapes will have only the HEX files, and then only for
   the non I/D space tasks. The DECUS tapes will have the HEX and TASK
   images,  except in the case of the I/D images, only the task images
   will be present.


K11   .BWR    Notes regarding possible bugs
K11   .COM    Task build DCL command file for RSTS+RMSRES Kermit
K11   .ODL    Overlay for K11.TSK
K11   .TSK    RSTS/E Kermit, v8.0 or later, linked to RMSRES
K1180S.MAC    Subroutines specific to RSTS/E
K11AAA.AAA    General AAAREADME.TXT
K11ART.RNO    Old newsletter article
K11ASM.COM    Generates DCL command files to assemble under BATCH
K11ASM.E80    Assemble Kermit for RSTS/E
K11ASM.M41    Assemble Kermit for RSX11M, RSX11M+ and P/OS (under RSTS)
K11ASM.RT4    Assemble Kermit for RT11 and TSX+, again, under RSTS
K11ATR.MAC    Attribute packet processing
K11CDF.MAC    Macro definitions for commands, a .INCLUDE file
K11CM1.MAC    Overlay for some commands
K11CMD.MAC    Main program
K11COM.MAC    Overlay for defining commands
K11CPY.MAC    The COPY command
K11CVT.MAC    Filename conversion routines
K11DAP.E80    ODL file for including DAP support for K11NRS.TSK (RSTS)
K11DAP.M41    ODL file for including DAP support for K11RSX.TSK (RSX)
K11DAT.MAC    Global read/write data
K11DEB.MAC    EXAMINE command (debugging)
K11DEF.MAC    Packet definition .INCLUDE file
K11DER.MAC    RSX11M directive errors
K11DFH.MAC    Help to be printed if the help file open fails
K11DIA.MAC    The DIAL command, also SET MODEM and SHOW DIAL
K11DSP.MAC    Dispatching module for RT11
K11E80.MAC    RSTS specific support
K11ECO.MAC    RSTS connect command
K11EDI.MAC    The command line editor/recall
K11ER1.MAC    RSM11 error text overlay
K11ER2.MAC    RSM11 error text overlay
K11ER3.MAC    RSM11 error text overlay
K11ERR.MAC    Driver for RMS11 error messages
K11F85.RNO    Text for Fall 85 Decus notes
K11FB .MAC    Root module for RT11 SJ/FB Kermit
K11FIL.DOC    This file
K11FIX.MAC    Fix file attributes for encoding the hex files (RSTS)
K11HEX.B2S    Basic+2 program to convert HEX to TSK (RSX,RSTS)
K11HEX.BAS    Basic+  program to convert HEX to TSK (RSTS)
K11HEX.COM    Creates the HEX files
K11HEX.FTN    Fortran 77 program to convert HEX to TSK (RSX,RSTS)
K11HEX.MAC    Macro-11 program to convert HEX to SAV (RT11)
K11HLP.HLP    The HELP file
K11HLP.MAC    Processes the HELP command
K11HLP.RNO    The source file for K11HLP.HLP
K11ID .COM    Build Kermit under RSTS for I/D space
K11ID .ODL    Overlay to build Kermit for I/D space on RSTS V9.x
K11ID .TSK    Executable for Kermit under RSTS and I/D space
K11IDM.COM    Same as K11ID.COM, but for RSX11M+ and Micro/RSX
K11IDM.ODL    Same as K11ID.ODL, but for RSX11M+ and Micro/RSX
K11IDM.TSK    Same as K11ID.TSK, but for RSX11M+ and Micro/RSX
K11INI.MAC    Initialization, packet logging
K11INS.DOC    Installation notes
K11INS.RNO    Source of K11INS.DOC
K11LCL.MAC    Restrict commands
K11M41.MAC    RSX11M, RSX11M+ and P/OS specific routines
K11MAC.MAC    Macro defintions, for .INCLUDE
K11MCO.MAC    RSX11M and RSX11M+ connect module (terminal emulation)
K11NHD.MAC    Prefix file to define EIS instructions as macros, RT11
K11NRS.COM    Task build RSTS for no RMSRES
K11NRS.ODL    Ditto
K11NRS.TSK    RSTS image NOT linked to RMSRES
K11PAK.MAC    Low level packet processing
K11PCO.MAC    Connect module called for P/OS
K11PK .MAC    RSTS specific, spawn 'subprocess'
K11POS.COM    Task build Kermit for RSX11M+, Micro/RSX and P/OS
K11POS.ODL    Ditto
K11POS.TSK    Executable of above
K11POS.XRF    Global cross reference
K11PRT.MAC    Support for XC, XL, CLn and KL under RT11 and TSX+
K11RCO.MAC    Connect code for RT11 and TSX+
K11REC.MAC    Incoming file protocol processing
K11RMS.MAC    File access routines for RSX11M/M+, RSTS/E and P/OS
K11RMZ.MAC    Misc RMS11 routines
K11RSX.COM    Task build Kermit for RSX w/o RMSRES
K11RSX.ODL    Ditto
K11RSX.TSK    Executable of non-RMSRES RSX version
K11RT4.COM    Assemble for RT11
K11RT4.MAC    RT11 and TSX+ file access
K11RT4.SAV    Executable for RT11 and TSX+, not for use under XM
K11RTD.MAC    Directory operations for RT11
K11RTE.MAC    Error messages for RT11
K11RTI.MAC    Initialization for RT11
K11RTT.MAC    Multiple terminal service support for RT11
K11RTU.MAC    Misc utility routines for RT11
K11SEN.MAC    Outgoing file protocol processing
K11SER.MAC    Server support
K11SHO.MAC    The SHOW command
K11SML.COM    Task build file for tightly overlayed RSX11M Kermit
K11SML.ODL    Overlay for above
K11SML.TSK    Executable
K11ST0.MAC    A SET command overlay
K11ST1.MAC    A SET command overlay
K11STD.MAC    SET command definitions
K11SUB.MAC    Misc utility routines common to all execs
K11TRA.MAC    The TRANSMIT command
K11TSX.MAC    TSX remote support
K11USR.DOC    Main user documentation
K11USR.RNO    Source for K11USR.DOC
K11XM .COM    Link Kermit-11 for RT11 XM and TSX+
K11XM .MAC    Root module for XM Kermit
K11XM .SAV    The executable for RT11 XM and TSX+

.eli
.subtitle RSTS/E installation
.page
.index RSTS/E Kermit installation
.s 2
.c;Installation of Kermit-11 on RSTS/E
.s 1

The minimum version of RSTS/E must be 8.0 or later for Kermit to
function correctly. Kermit will run on version 7.2, but there will
be random problems with file access. This is due to the use of RMS11
version 2 in Kermit-11 for all file activity; version 7 of RSTS/E
supports only RMS version 1.8.
.br
Kermit's use of RMS11 costs you NOTHING. You have the option of using
an image that contains RMS in disk overlays (K11NRS.TSK),
or you can use one that's
linked to the segmented RMS resident library, RMSRES (K11.TSK).
The pros and cons
of using RMS will not be discussed; there aren't any valid reasons NOT to
use it.
.s 1
Be sure that the SYSGEN question relating to multiple private delimiters
was answered YES, otherwise Kermit will tell you it can't run without it
as soon as you attempt a file transfer. Multiple delimiter masks cost you
one word in executive data space to be used as a pointer to a small buffer
containing the delimiter mask; the small buffer is not allocated until
Kermit requests the monitor to do so.
.s 1
If you are running RSTS 9.3 or later, you can, if your CPU supports it,
use a Kermit-11 build with I/D space support. The supported cpu's are:
.s 1
PDP 11/44, PDP 11/45, PDP 11/70, PDP 11/73 and PDP 11/84.
.s 1
If this is the case, the replace all references to 'K11.TSK' with 'K11ID.TSK'.
Though note, that if you have obtained your distribution from COLUMBIA, that
their tape will NOT include the file K11ID.HEX, due to space limitations.
This implies that you would have to build that image from source, using the
files K11ASM.E80, K11ID.COM and K11ID.ODL.
.s 2
Tape distribution:
.s 1
There are many different possibilities here. You may have an ANSI-D tape
from Columbia, a backup tape from a friend, a DOS format tape from DECUS,
or even RX50's for a Micro-11 system. All following examples are done under
RSTS/E version 9.0 or later.
.s 1
.lit
(1) DOS format Kermit-11 tape

    $ MOU MM0:/FOR=DOS
    $ PIP MM0:[*,*]*.*/L:S
    $ PIP SY:[1,2]=MM0:[*,*]K11.TSK
    $ PIP SY:[1,2]=MM0:[*,*]K11HLP.HLP
    $ PIP SY:[1,2]=MM0:[*,*]K11USR.DOC
    $ SET FILE [1,2]K11.TSK/RUN=RSX/PRO=104
    $ SET FILE [1,2]K11HLP.HLP/PRO=40
    $ DEFINE/COMMAND/SYSTEM KER-MIT [1,2]K11.TSK/LINE=30000

The above commands did the following:

    (1) Insure the tape label format is DOS-11
    (2) Get a directory to make sure the files are really there
    (3) Copy the executable task image (linked to RMSRES)
    (4) Copy the online help file
    (5) Copy the Kermit-11 users guide
    (6) Set protection and runtime system name
    (7) Create a CCL definition for Kermit to be invoked with

.eli
.test page 10
.lit
(2) Ansi D format tape from Columbia

    $ MOU MM0:/FOR=ANS KERMIT    ! RSTS/E 9.0 or 9.1
    $ MOU MM0:/OV=ID        ! RSTS/E 9.2 or later
    $ PIP SY:=MM0:K11.HEX
    $ PIP SY:=MM0:K11HEX.BAS
    $ PIP SY:[1,2]=MM0:K11HLP.HLP
    $ PIP SY:[1,2]=MM0:K11USR.DOC
    $ BASIC
    old k11hex
    run
    K11HEX- Decode Kermit-11 Hex files (RSTS/E Basic+)
    Input Hex file ? K11.HEX
    Output Task image? K11.TSK
    $
    $ COP/REP K11.TSK [1,2]
    $ SET FILE [1,2]K11.TSK/RUN=RSX/PRO=104
    $ SET FILE [1,2]K11HLP.HLP/PRO=40
    $ DEFINE/COMMAND/SYSTEM KER-MIT [1,2]K11.TSK/LINE=30000

Again, the sequence of operations is:

    (1) Insure current tape labeling is ANSI
    (2) Copy a hexified version of the task image
    (3) Copy a simple Basic+ program to create the task image
    (4) Copy online help file and user documentation
    (5) Switch to Basic+
    (6) Run the K11HEX program, creating a task image
    (7) Copy the task image to [1,2]
    (8) Set runtime system, protection and ccl command.

.eli
If the tape label for an ANSI tape is unknown, you can switch
to Basic+ or RSX keyboard monitors and do an ASSIGN MM0:.ANSI
as the RSTS/E DCL Mount command lacks an override switch
for volume identification. If the DCL command BASIC fails, try the
ccl command SY/R to find out what Basic is called, and then try
a SWITCH nnnnnn ccl command, where 'nnnnnn' is the Basic+ run time
system name. For example, the author always uses BAS4F for the basic
run time system (to designate 4 word FP11/KEF11 support), and the DCL symbol
BASIC is defined as BASIC :== CCL SWI BAS4F.
.br
If PIP gives you an error message regarding insufficient buffer space,
redefine the CCL command definition for PIP to extend PIP to 28KW; this
is done by specifying a line number in the form 8192+size(KW).
.s 2
(3) RX50 or RX01 floppy diskettes
.s 1
The DECUS Library Micro-RSTS distribution is on RT-11 formatted
RX50 diskettes; the Decus Library (Decus number 11-731) alternate
distribution media on RX01's is also a set of RT-11 formatted floppy
diskettes. These are readable on RSTS/E with the program FIT, supplied
with your system. If you have RSTS/E Kermit on floppies, the first
thing to do is to get directory listings of all the diskettes so you
know which floppy to use for a given file. The following example is
the general method:
.lit

    $ RUN AUXLIB$:FIT
    FIT    V9.0-14 RSTS V9.0-14 U of Toledo 44
    FIT>SY:=DX0:*.*
    FIT>SY:=DX0:*.*
    FIT>^Z
    $ COP/REP K11HLP.HLP [1,2]
    $ COP/REP K11.TSK [1,2]
    $ SET FILE [1,2]K11.TSK/RUN=RSX/PRO=104
    $ SET FILE [1,2]K11HLP.HLP/PRO=40
    $ DEFINE/COMMAND/SYSTEM KER-MIT [1,2]K11.TSK/LINE=30000

.eli
Since there are only two or three floppy diskettes involved it is
convenient to copy all the diskettes to your account, and then move
the needed files to their final destination. In the above example, it
is assumed that a different diskette was placed into DX0 before the
second file transfer
command was issued. In the case of RX50 diskettes, the input device
name would be DUn, where 'N' is the number of winchester drives (hard
disks)
on your system.
For example, if you have one RD52 on your system, then floppy drive zero
is called DU1:.

.s 1
In summary, you want to copy K11.TSK from the media and install it
somewhere with world read+execute access and preferably define a CCL
command for it. Dialup access is documented at the end of this file
for obtaining newer Kermit-11 versions.
.subtitle RT-11 and TSX+
.test page 10
.index RT-11 and TSX+ Kermit installation
.s 2
.c;Installation of Kermit-11 on RT-11 and TSX+
.s 1
RT-11
.s 1
Kermit-11, as used under RT-11, supports the use of multiple terminal
service, the XC and XL handlers found on version 5 of RT-11, and, in
extreme cases, the use of the console line for connecting TO the RT-11
system.
.s 1
The first option, the use of Multiple Terminal support, requires a
SYSGEN if this feature is not configured. Serial lines in this case
are designated by numbers; the console is always line zero, the next
line, say a DLV11E, may be line one. These line numbers are assigned
during SYSGEN based upon the order of entry during SYSGEN (under 5.2,
the questions start with question number 180). You can also use a DZ11
or DZV11. The actual assignments may be viewed on a running system
with the DCL command SHO TER.
.s 1
The best solution is to use the XL driver (XC on PRO/RT-11), available
on RT-11 version 5.1 and 5.2.
This is a driver
that makes very efficient use of a DLV11 compatible interface; it's
the same handler that is used by VTCOM. To use it, you must have, just
like for multiple terminal support, an extra DL11/DLV11 interface in addition
to the console interface. The XL handler supports two DCL commands:
.lit

    SET XL CSR=n
    SET XL VECTOR=m

.eli
Where 'N' is the address of the CSR (control status register) and 'M' is
the interrupt vector address. The defaults are 176500 for the CSR, and 300
for the interrupt vector.
.br
The XC handler, used ONLY on the PRO/300 series,
has it's CSR and vector fixed at 173300 and 210 respectively. Kermit-11,
upon finding itself running on a PRO/3xx under RT-11, does an implicit
SET LIN XC:. The DCL command SET XC SPEED=N must be used outside of Kermit
to change the XC line speed from the default of 1200 baud.
.s 1
Last, but not least, if there is no way to get an additional interface
into your system (perhaps you have a four slot QBUS backplane), you
can force Kermit to use the console. This implies, of course, that it
will not be possible to dial out from the RT-11 system; the system could
be used only for a remote Kermit to connect to it via the console port.
If Kermit finds that the XL handler is not present, and that multiple
terminal service is absent, it will force the use of the console. Otherwise,
the command:
.lit

    Kermit-11>SET LINE TT:

.eli
will force the console to be used.
.s 1
In summary, the following commands (in order) specify serial lines for
Kermit-11:
.lit

    Kermit-11>SET LINE 1        use terminal line one
    Kermit-11>SET LIN XL        use the XL handler
    Kermit-11>SET LIN TT:        force use of the console line

.eli

Kermit-11 also requires the presence of timer support in the executive.
This is required to support the .TWAIT directive; FB and XM systems always
have support for this; SJ systems by default do not. If Kermit decides that
it does not have a clock, which it would think if .TWAIT support is missing,
it will try to fake .TWAIT's with cpu bound loops. The best thing is to
insure that you have a FB or XM monitor available for use with Kermit.
.s 2
TSX+
.s 1
Kermit-11 is used on TSX+ (a product of S_&H Computing) as both a LOCAL
Kermit (you connect out to another system using the CL handler) and a
REMOTE Kermit (you log into a TSX+ system and run Kermit-11 to communicate
with your local Kermit system). The second is identical to Kermit use
on most multiuser systems (for example, TOPS-20 and RSTS/E), while the
former is similar to Kermit use on RT-11 with the XL/XC handler.
In order to CONNECT out from TSX Kermit to another system, you need to
associate the appropriate CL line with the logical name XL, or, if you
are running Kermit-11 2.44 or later and have 8 CL lines or less, you
can directly specify the CL unit number:
.lit

    .SET CLn LINE=4
    .SET CL NOLFOUT
    .ASS CLn XL
    .KERMIT
    Kermit-11>SET LIN XL
    Kermit-11>CONNECT
   or:

    Kermit-11>SET LIN CLn

.eli
where 'N' is the CL unit number, or just CL for CL0:.
Please consult the Kermit-11 User's Guide for further information regarding
serial line support.
.s 1
The image K11XM.SAV will use approximately 100 blocks of PLAS swapfile
space; if that is excessive, or if Kermit fails to load, then the
disk overlayed image K11RT4.SAV may be used. Alternately, the TSGEN.MAC
parameter SEGBLK may be too small to contain K11XM's virtual overlay; the
TSX+ system manager will need to increase SEGBLK and reboot TSX+.
.s 2
Installing Kermit on RT-11 and TSX+
.s 2
As in the case of RSTS/E, there are so many media formats that may
be used for Kermit that we must restrict the discussion to the more
likely media. First of all, the files of interest are:
.lit

    K11XM.SAV    For use on RT-11 XM, PRO/RT-11 and TSX+
    K11RT4.SAV    For use on RT-11 SJ and FB, also usable on TSX+
    K11HLP.HLP    The online help file
    K11USR.DOC    The user's guide

.eli
The most common media that RT-11 and TSX+ users may get Kermit-11 is
on 8 inch RX01 diskettes and 5 1/4 inch RX50 floppies. Both examples
reference RX50 devices, the use of RX01 and RX02 disks is the same
except that a RX01 (RX11-BA and RXV11-BA) drive is called DX and
the RX02 drive is called DY. Additionally, the eight inch floppies
have a lower capacity than an RX50, thus Kermit-11 files may be
split across two or more diskettes.
The RX50 drives are known as DZ0: and DZ1: on the PRO/350, and they are
known as DUn: and DUn+1: on other QBUS processors, when N is the number
of fixed drives (RD50,51 and 52). If your system is NOT a PRO/3xx series
systems, you would need to replace the references to DZn: with the
appropiate DU device names. For example, if you have one RD52 winchester
drive and two RX50 units, then the first RX50 would be DU1: and the second
DU2:. The RC25 is an exception; if your system had one RC25 and an RX50,
then the first RX50 would be called DU4:. If your system contained no
MSCP disk drives other than the RX50, then the units would be DU0: and DU1:.
.lit

(1) RT-11 5.2 and PRO/350, files on RX50 media

    .COPY DZ0:K11XM.SAV DK:KERMIT.SAV
    .COPY DZ0:K11HLP.HLP DK:
    .COPY DZ0:K11USR.DOC DK:
    .SET XC SPEED=9600
    .KERMIT
    Kermit-11 T3.44 Last Edit: 04-Feb-86
    PRO/350 comm port set to XC0:
    Kermit-11>EXIT

.eli
Since this was a PRO/350, we must use the K11XM.SAV executable image,
since only RT-11XM will run on the PRO. Had this been a PDP-11 running
RT-11 SJ or RT-11 FB, we would have copied K11RT4.SAV to KERMIT.SAV rather
than K11XM.
.lit

(2) RT-11 5.2 FB and LSI-11/23

    .COPY DU1:K11RT4.SAV DK:KERMIT.SAV
    .COPY DU1:K11HLP.HLP DK:
    .COPY DU1:K11USR.DOC DK:
    .SET XL CSR=176510
    .SET XL VEC=310
    .KERMIT
    Kermit-11 T3.44 Last Edit: 04-Feb-86
    Kermit-11>SET LIN XL:

.eli
In this case, we had one winchester fixed disk drive, DU0:, thus the
RX50 units are called DU1: and DU2:
We also have a DLV11 at a CSR and VECTOR of 176510 and 310,
respectively, which differs from the default 176500 and 300. Since the
DLV11's speed is set via onboard switch packs, the DCL command SET XL SPEED
command is not usable.
.s 1

.lit

(3) RT-11 without the Kermit save image

    .COPY DU1:K11XM.HEX DK:
    .COPY DU1:K11HEX.MAC DK:
    .R MACRO
    *K11HEX=K11HEX
    *^C
    .R LINK
    *K11HEX=K11HEX
    *^C
    .RUN K11HEX
    *K11XM=K11XM
    .RUN K11XM
    Kermit T3.44 Last edit: 04-Feb-86
    Kermit-11>EXIT
    .

.eli
In this case, it is assumed that we have the files K11XM.HEX (or K11RT4.HEX)
and K11HEX.MAC, perhaps obtained from a remote system with VTCOM. After
copying the two files we assembled and linked the K11HEX program. The K11HEX
program is then run to create the desired save image. Keep in mind that K11XM
is for TSX+, RT-11 XM and the PRO/350, whereas K11RT4 is for SJ and FB systems.
Again, the disk configuration was one MSCP winchester disk
(a RD50, RD51 or RD52) and two RX50 units.
.s 2
In the event that you are using multiple terminal support, you could
use a command of the form:
.lit

    .SHO TER
    Unit  Owner      Type       Width  Tab  CRLF  FORM  SCOPE  SPEED
    0         S-Console DL   132   No   Yes    No    No    N/A
    1            Remote    DL    80   Yes  Yes    No    No    N/A

    .KERMIT
    Kermit-11 T3.44 Last Edit: 04-Feb-86
    Kermit-11>SET LINE 1

.eli
otherwise use the XL (XC for the PRO) handler. The XL handler must be
previously
installed; it does not have to be loaded. Kermit will fetch the handler
if it is not resident.
.lit

    .INS XL
    .KERMIT
    Kermit-11 T3.44 Last Edit: 04-Feb-86
    Kermit-11>SET LIN XL
    Kermit-11>CONNECT

.eli

.subtitle P/OS and the PRO/3xx
.test page 10
.index P/OS Kermit installation
.s 3
.c;Installation of Kermit-11 on P/OS
.s 1
P/OS Kermit-11
.s 2
Kermit-11, running on the PRO/350 and 380 under P/OS, runs under control
of DCL. DCL is normally installed at system generation time; it is an
optional application. DCL can also be installed under the PRO/TOOLKIT.
The DECUS distribution,
on RX50 diskettes, has all the needed files
under the directory [001002], or, in Files-11 ODS1 terms, in UIC [1,2].
Thus, installing Kermit-11 under P/OS from RX50's is quite simple:
.lit

    $ COPY/CONT DZ1:[1,2]K11POS.TSK [USERFILES]
    $ COPY/CONT DZ1:[1,2]K11HLP.HLP [1,2]

.eli
Where DZ1 is the first floppy drive unit, as opposed to RT-11, where DZ0 is
the first floppy drive unit.
.br
Thus, assuming that the current default directory is [USERFILES], one simply
types:
.lit

    $ RUN K11POS
    Kermit-11 T3.44 Last edit: 04-Feb-86
    Line set to XK0: at 9600 baud
    Kermit-11>

.eli
As noted, the PRO/3xx Kermit-11 can make use of XT1: and XT2: to access the
PRO/TMS Telephone Management System. If a SET LINE XT1:
(or XT2:, when applicable) is done, then the Kermit-11 DIAL command can be used
to access the TMS internal modem to place an outgoing call. All needed
formatting characters MUST be imbedded in the TMS dial string. If the DIAL
command is used, and the line name starts with 'XT', then it is assumed that
TMS is being used; otherwise you would be required to use the SET MODEM command
prior to issuing the DIAL command.
Further information regarding DIAL and SET MODEM is available in the Kermit-11
User's Guide and in the online HELP file.
.s 1
The other obvious way to get Kermit-11 onto your PRO is by bootstrapping
Steven's PRO Kermit or Bob Denny's PRO Kermit
to download the task image, or by using PFT to transfer
the task image from an RSX-11M+ or VMS host (this is left for the reader to
explore).
.s 1
The other method to load Kermit-11 on to a PRO/3xx P/OS system is by
transferring the files K11POS.HEX (a 'Hexified' task image) and K11HEX.FTN
(a Fortran-77 program) or K11HEX.B2S (a Basic+2 program) using
PRO/Communications (Pro/Comm).
The K11HEX programs
are intended to convert the 'HEX' file format into an executable task image;
instructions are contained in the respective source files for compiling and
task building. Please note that whenever a task image is transferred to an RSX
based system, as P/OS is, the image MUST be made contiguous, as in:
.lit

    $ COPY/CONT K11POS.TSK K11POS.TSK        P/OS under DCL
    > PIP K11POS.TSK/CO=K11POS.TSK            RSX-11M under MCR

.eli
.s 1
The last note regards FUNCTION key mapping; K11POS will, while in CONNECT
mode, map the following keys:
.lit

    F5  (Break)    Control\ B will send a break to the remote system
            as well as typing F5.
    F6  (Interrupt)    Send a Control C (03  octal) to remote
    F10 (Exit)    Send a Control Z (032 octal) to remote
    F11 (ESC)    Send Escape      (033 octal) to remote
    F12 (BS)    Send Backspace   (011 octal) to remote
    F13 (LF)    Send LineFeed    (012 octal) to remote

.eli
.subtitle RSX-11M/M+ Installation
.test page 10
.index RSX-11M and RSX-11M Plus installation
.s 3
.c;Installation of Kermit-11 on RSX-11M and RSX-11M Plus
.s 1
Kermit-11 runs under RSX-11M 4.0 or later, RSX-11M Plus 2.1 or later,
and MicroRsx version 3. All file activity is done through RMS11 version
2; this is one compelling reason why Kermit can not function on earlier
versions of RSX. The use of RMS11 does, however, give you transparent
support for Decnet and compatability of Kermit's file system between
RSX, P/OS and RSTS/E.
.br
There are two distributed task images for RSX. The file K11RSX.TSK is
used on RSX-11M and can also be used on RSX-11M Plus, and has DECNET
support linked into the image.
The other image,
K11POS.TSK, is usable only on RSX-11M Plus and MicroRSX, as it is
linked to the segmented RMSRES resident library. It is NOT linked
to DAPRES, thus if Decnet access is required, the former task image
must be used.
.s 1
The main distribution methods for Kermit on RSX are via DOS-11 formatted
magnetic tape, Ansi-D tape from Columbia University and the RSX SIG symposia
tape (in BRU or VMS Backup format).
The former, DOS-11, is the format that the Decus library's copy of Kermit-11
(Decus number 11-731). There is an alternative distribution from DECUS on
either RT-11 formatted RX01 diskettes, or on ODS1 RX50 diskettes.
.lit

(1) DOS format magtape

    > MOU MM0:/FOR
    > INS $FLX
    > FLX SY:/RS=MM0:[*,*]K11RSX.TSK/DO
    > FLX SY:/RS=MM0:[*,*]K11POS.TSK/DO
    > FLX SY:/RS=MM0:[*,*]K11HLP.HLP/DO
    > FLX SY:/RS=MM0:[*,*]K11USR.DOC/DO
    > PIP [1,54]/CO=K11RSX.TSK
    > PIP [1,2]/CO=K11HLP.HLP
    > PIP [1,54]K11RSX.TSK/PR/WO:R
    > PIP [1,2]K11HLP.HLP/PR/WO:R
    > INS $K11RSX/TASK=...KER

    (1)  The tape is mounted foreign
    (2)  FLX is installed, if it is not already
    (3)  The main Kermit-11 RSX task image is copied
    (4)  The alternate task image is copied
    (5)  The online HELP file is copied
    (6)  The users guide us copied
    (7)  The task is copied to [1,54] and made contiguous
    (8)  The help file is copied to [1,2] and made contiguous
    (9)  The task image's protection is set to WORLD read access
    (10) The HELP file's  protection is set to WORLD read access
    (11) The task image is installed as KER

.eli

.s 2
.lit
(2) ANSI D format tape from Columbia University

    >MOU MM0:/OV=ID
    >PIP SY:=MM0:K11RSX.HEX
    >PIP SY:=MM0:K11HEX.FTN
    >PIP SY:=MM0:K11HLP.HLP
    >PIP SY:=MM0:K11USR.DOC

.eli
The tape set, as it comes from Columbia University, is blocked
at 8192 bytes per tape block. This could cause PIP to fail unless
PIP is installed with a very large size increment. If this should occur,
you will get an error message similar to:
.lit

    PIP - open failure on input file
    MM0:[5,20]K11RSX.HEX;1  No buffer space available for file

To correct this you can do one of two things:

    >INS $PIP/TASK=...XPP/INC=50000
    >XPP SY:=MM0:K11RSX.HEX
    >XPP SY:=MM0:K11HEX.FTN
    >XPP SY:=MM0:K11HLP.HLP
    >XPP SY:=MM0:K11USR.DOC
    >REM XPP

or:

    >RUN $PIP/INC=50000
    PIP>SY:=MM0:K11RSX.HEX
    PIP>SY:=MM0:K11HEX.FTN
    PIP>SY:=MM0:K11HLP.HLP
    PIP>SY:=MM0:K11USR.DOC
    PIP>^Z
    >

.eli
.s 1
Note that we could not get K11RSX.TSK from this tape; it's not there.
Instead we copied K11RSX.HEX, a file that can be run through the K11HEX
program(s) to create the needed task image.
.lit

    >F77 K11HEX=K11HEX
    >TKB
    TKB>K11HEX=K11HEX,LB:F4POTS/LB
    TKB>/
    Enter Options:
    TKB>maxbuf=512
    TKB>//
    >RUN K11HEX
    Input  file ? k11rsx.hex
    Output file ? kermit.tsk
    Encode or Decode ? decode
    all done
    >PIP [1,54]/CO=K11RSX.TSK
    >PIP [1,2]/CO=K11HLP.HLP
    >PIP [1,54]K11RSX.TSK/PR/WO:R
    >PIP [1,2]K11HLP.HLP/PR/WO:R
    >INS $K11RSX/TASK=...KER

.eli
.s 1
.lit
(3) RT-11 Format RX01 diskettes

    > MOU DX0:/FOR
    > MOU DX1:/FOR
    > FLX SY:/RS=DX0:K11RSX.TSK/RT
    > FLX SY:/RS=DX1:K11HLP.HLP/RT
    > FLX SY:/RS=DX1:K11USR.DOC/RT
    > PIP [1,54]/CO=K11RSX.TSK
    > PIP [1,2]/CO=K11HLP.HLP
    > PIP [1,54]K11RSX.TSK/PR/WO:R
    > PIP [1,2]K11HLP.HLP/PR/WO:R
    > INS $K11RSX/TASK=...KER

.eli
RX01's diskettes can hold approximately 470 blocks of data; this implies
that there will be at least two, if not three, diskettes involved. You
will need to try a different diskette if the desired file(s) is not present
on the currently mounted disk. Also, if you have an RX02 drive instead of
an RX01 drive, the device name will be DY instead of DX.

.s 2
Please note that RSX Kermit is a privileged task; it's built with the
/PR:0 TKB switch. This is required so that Kermit can access terminal
lines other than your own; as would be the case when you are dialing
out from your system. The task does, however (under RSX-11M Plus and
MicroRSX), drop and regain privilege
when it needs it; for example, the SET LINE and CONNECT commands both
have to issue set multiple characteristics calls to condition the
serial line being used.
.subtitle IAS version 3.1 and 3.2 update A and B
.test page 10
.index IAS version 3.1 and 3.2 update A and B
.s 2
.c;Note regarding Kermit-11 on IAS
.s 1
This information regarding IAS Kermit was provided by the EPA in
there conversion of Kermit-11 to run under IAS version 3.1.
The current version of IAS Kermit-11 is based on base 2.30 of
Kermit-11. It will likely stay at this base level forever; the
conversion was done for use with RMS11 version 1, which will be
superceded by RMS11 version 2 in IAS 3.2 Update C. At that point
the IAS 3.1 Kermit task image, K11I31.TSK, will no longer function since
it is linked to an RMS version 1 resident library. The RMS resident
libraries were redone for RMS v2 in order that (1) the library can be
segmented into multiple libraries and (2) the entry point addresses are
never changed, thus new versions of the reslib do not force the user
to relink ones task images.
.s 2
Restrictions and notes:
.s 1
1) Dial-out lines must not be interactive terminals.
That is, if you are going to use a line as a dial-
out line, you must not allocate it to PDS or SCI.
.s 1
2) Spawning installed tasks is currently done via a
SPWN$ directive rather than via RUN$T.  Therefore,
anyone wanting to spawn installed tasks must have
the PR.RTC (real-time) privilege.  A workaround is
to exit from Kermit, run the program, and then
run Kermit again.  Kermit will first try to run an
installed task named $$$xxx, where xxx is the system
command requested;  if that fails, Kermit will try
to run an installed task named ...xxx.
.s 1
3) Wild-card file operations are supported (for example,
DIR *.DAT, DEL *.TSK, SEND *.MAC).  Under RSX, Kermit
uses RMS version 2 to do wild-card operations;  this
is available under IAS V3.2 but not under IAS V3.1.
Therefore, on IAS V3.1 (the version that the EPA is
running), there are the following restrictions on file
operations::
.lm 5
.s 1
a) Wild-cards must be specified for the entire
field or not at all.  For example, TEST.*
is OK but TEST*.* is not.
.s 1
b) If a wild-card file operation is executed,
with either the file-name or the file-type
specified as a wild-card, the file version
number is also taken to be a wild-card.
.s 1
c) Wild-card operations are not allowed on
directories.  Therefore, [*,*]*.DAT is not
a legal wild-card operation in Kermit-IAS.
It is legal to use explicit directories, such
as [200,200]*.DAT.
.s 1
d) RMS Version 2 supports transparent DECNET
remote file operations, while RMS Version 1
does not.  Therefore, Kermit-IAS under IAS V3.1
does not support DECNET file transfers.
.s 1
e) Renaming files within Kermit is not supported
under V3.1 of IAS.
.lm 0
.s 2
4) Kermit under IAS currently reads packets one character
at a time, and so can use up a fair amount of the CPU
if it is receiving files.  If it is sending packets
(sending files or remote command responses), or if it
is reading commands rather than its file transfer packets,
it will use long I/O operations and will not put an
excessive burden on the system.
.s 2
Installation:
.s 1
Kermit is built as a multi-user task, with a task name of
$$$KER.  It can be run as an installed "foreign command"
task:
.s 1
.lit
    PDS> install k11ias
    PDS> kermit
    Kermit-11 T2.30
    Kermit-11>...

You can also specify another name for the installed command:

    PDS> install/sys:k11 k11ias
    PDS> k11
    Kermit-11 T2.30
    Kermit-11>...

Or you can just run it as a non-installed task:

    PDS> run k11ias
    16:30:15
    Kermit-11 T2.30
    Kermit-11>...

The following files are supplied for Kermit-IAS to run:

    K11I31.TSK    - The Kermit task image
    K11HLP.HLP    - The Kermit help file.  For this to be used by
              Kermit, it must be in the default directory.
    K11I31.DOC    - This file, describing Kermit on IAS
.eli
.s 4
.subtitle Obtaining updates of Kermit-11
.index Obtaining updates of Kermit-11
.s 1
.c;Obtaining Kermit-11 updates from the University of Toledo
.s 1
From Bitnet server on U of Toledo's 11/785
.s 1
.lit
from VM/CMS:    CP SMSG RSCS MSG UOFT02 KERMSRV DIR
        CP SMSG RSCS MSG UOFT02 KERMSRV SEND K11*.*

from VMS Jnet:    $ SEN/REM UOFT02 KERMSRV SEND K11*.*


Dialup access to the 11/785:

    [phone]
    Service class  VX785A
    User: KERMIT
    Password: KERMIT

Source and hex files are in KER:, binaries are in KERBIN:

.eli